home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / rdrm20.zip / IMPORT.DOC < prev    next >
Text File  |  1993-04-15  |  11KB  |  238 lines
  1.               ┌─────────────────────────────────────────┐
  2.               │               IMPORT V1.0               │
  3.               │     Import Utility for READROOM Door    │
  4.               │ (C) Exhibit A Communications, 1992-1993 │
  5.               └─────────────────────────────────────────┘
  6. ┌────────────────────┐
  7. │  About IMPORT      │
  8. └────────────────────┘
  9.  
  10.         IMPORT is a little utility designed to ease the burden on sysops
  11. running the READROOM door.  This utility will scan the configuration
  12. file for READROOM door and will try and locate new versions of the
  13. publications in the door.  If any are found, they will be opened up into
  14. the appropriate directory.  Supports publications archive in ZIP, ARJ,
  15. LZH and ARC formats.
  16.  
  17.         IMPORT is command line driven to allow sysops to add this
  18. utility to any batch file or event that they wish to automate the
  19. posting of a new publication.
  20.  
  21.         IMPORT will work hand in hand with the next version of LSTRELAY,
  22. due at the end of April 1993, to produce accurate reports to sysop as
  23. well as posting news files about the status of the most recent session.
  24. (Please see Appendix B for more information about LSTRELAY)
  25.  
  26.         Please note: this utility will only work with registered
  27. versions of the READROOM door!
  28.  
  29. ┌────────────────────┐
  30. │  About Shareware   │
  31. └────────────────────┘
  32.  
  33.         Shareware is a method of software distribution designed to benefit
  34. both the software developer and the end user.  Shareware (SW) should not
  35. be confused with Public Domain (PD) programs.  While  PD programs are
  36. released to the public with no restrictions attached to their use, SW
  37. programs are the copyrighted work of their authors.  The SW programs are
  38. released to the public for evaluation purposes under the assumption that
  39. if the end user likes the program and continues to use it after a
  40. reasonable period of time, that user is obligated to register the
  41. program.
  42.         If you purchased this program from a SW distributor, you have
  43. not registered it.  You must still pay the programmer to register it.
  44. The money you paid to the distributor was to cover the cost of
  45. duplicating/advertising/etc the files.
  46.         Programmers get to distribute their wares without the expense
  47. of advertising, packaging & distribution.  The users benefit from being
  48. able to try out the programs without having to pay for the privilege of
  49. evaluation.  Shareware programmers (the good ones anyway) are generally
  50. more responsive to bug reports & user requests for additional features.
  51. Everyone benefits provided that the users remember to register and
  52. programmers continue to ... well, program<G>.
  53.  
  54. ┌────────────────────┐
  55. │  Registration      │
  56. └────────────────────┘
  57.  
  58.         REMEBER, this utility will only work with a registered copy of
  59. the READROOM DOOR.  To register the READROOM door, please fill out the
  60. file ORDER.FRM, copy it to your printer and mail it along with a check
  61. for $15.00 to Exhibit A Communications at the address shown on the form.
  62.  
  63.         Or if you want to register painlessly, you can now register
  64. READROOM on CompuServe.  Just GO SWREG at any prompt.  Cost is the same
  65. to you and you don't have to mess with U. S(nail). Mail at all.
  66.  
  67.         By sending in your registration fee, you will be entitled to
  68. the following:
  69.         1) Enable use of IMPORT program.  Does not work in unregistered ver.
  70.         2) Continued use of this program on any single or multiuser BBS
  71.         3) Free upgrades to future versions
  72.         4) Enhanced support from programmer
  73.         5) The satisfaction of knowing that you are helping to make the
  74.                 shareware system alive
  75.         6) A jump to the next Karma level
  76.         7) The undying gratitude of my wife, son and dog <g>
  77.  
  78.  
  79. ┌────────────────────┐
  80. │  Requirements      │
  81. └────────────────────┘
  82.  
  83.         1) READROOM door MUST be registered for this utility to work.
  84.         2) Copies of the following programs must exist in a directory
  85.            that lies on your computer's path.
  86.                 a) PKUNZIP.EXE  required to open .ZIP
  87.                 b) ARJ.EXE      required to open .ARJ
  88.                 c) LHA.EXE      required to open .LZH
  89.                 d) PKXARC.EXE   required to open .ARC files
  90.         3) Properly configured READROOM door.
  91.         4) DOS 3.0 or higher.
  92.  
  93. ┌────────────────────┐
  94. │  Installation      │
  95. └────────────────────┘
  96.  
  97.         Installing IMPORT can be as simple as ensuring that IMPORT.EXE
  98. is located either on the path or in the same directory as you have
  99. called it from.  Please note that the files IMPORT.ERR and IMPORT.LOG
  100. will both be written to in the same directory where IMPORT.EXE is.  For
  101. this reason I suggest you put it in the same directory as the READOOM
  102. door.
  103.         Line 7 in the READROOM configuration file must contain the full
  104. drive/path to the directory you  want IMPORT to scan for new
  105. publications.
  106.         The Advanced Features line (number 4 for each publication) is
  107. where you will define what template IMPORT will use to find a new issue.
  108. This option must be defined for each publication you wish IMPORT to look
  109. for.  If you do NOT wish IMPORT to update a publication, just use NO for
  110. the template.  Templates use DOS wildcards to define the publication
  111. names.  To look for the latest PIMxxxx.ZIP file, you would use PIM* as a
  112. template.
  113.  
  114. ┌────────────────────┐
  115. │  Operation         │
  116. └────────────────────┘
  117.  
  118.         Operation of the IMPORT utility is as simple as adding IMPORT
  119. <readroom.cnf> to any batch file (or from the command line) that you
  120. wish.  I would suggest that you put it in one of your daily events, but
  121. that is not necessary for operation of the program.
  122.  
  123. ┌────────────────────┐
  124. │  Support           │
  125. └────────────────────┘
  126.  
  127.         READROOM is fully supported by it's programmer Michael J. Gibbs
  128. through Exhibit A Communications.  He can be reached in the following
  129. manners:
  130.         1) Intelec network
  131.                 conferences monitored:
  132.                         SYSOP
  133.                         PCRELAY
  134.                         BBS DOORS
  135.                         PROGRAMMING
  136.                         C PROGRAMMING
  137.                         INTELEC ADMIN
  138.         2) MediaNET network          node id:->EXHIBITA
  139.                 conferences monitored:
  140.                         MEDIANET ADMIN
  141.                         PRO PHOTO
  142.                         MEDIANET CHAT
  143.         2) RaceNet network           node id:->EXHIBITA
  144.                 conferences monitored:
  145.                         EXHIBITA
  146.                         OFFROAD
  147.                         RACENET SYSOPS
  148.         3) InfoMat BBS (714) 492-8727
  149.                 forum 7 is support for Exhibit A Programs
  150.         4) CI$  #72246,1653
  151.         5) Orange County Information Network
  152.                         EXHIBITA forum
  153.         6) FidoNet support offered through The Puffins Nest BBS
  154.                         (401) 437-3463 (1:261/1129)
  155.                         Latest version of the door Freq'able using
  156.                         "magic name" of READROOM.
  157.  
  158. ┌────────────────────┐
  159. │  Legal Disclaimer  │
  160. └────────────────────┘
  161. (small print on<g>)
  162.         As with any program, every attempt is made by the programmer to
  163. kill all the bugs in the software before it is release to the public.
  164. Since this is all but impossible, it is recommended that new software
  165. should only be run (for the first time at least) when a current backup
  166. of your hard disk is available.  When shareware is released for public
  167. evaluation, there is little that can be done on the programmer's end to
  168. prevent others from infecting the program with viruses or making
  169. unauthorized changes to the program.  AS SUCH, user agrees to hold
  170. harmless MICHAEL J. GIBBS, INFOMAT BBS and EXHIBIT A COMMUNICATIONS in
  171. regards to any personal, physical, emotion, financial, sexual or other
  172. damage that may occur to hardware, software or the user that may arise
  173. from the use of this program.  Use of this program is considered to be
  174. acceptance of these conditions.
  175.         This program remains the copyrighted work of Exhibit A
  176. Communications.  When you register the program, you are granted a
  177. license to use this program on one (1) BBS system, regardless of how
  178. many nodes are active.  You may sell your registered number to another
  179. if the following conditions are met:
  180.         1) All copies of the software and any documentation are
  181.                 transferred to the new owner.
  182.         2) You must discontinue use of the program following the sale.
  183.         3) The new owner must contact Exhibit A Communications to update
  184.                 our user records.
  185.         This program may not be sold in it's unregistered form.  It is
  186. intended to be distributed freely.  Pay BBS systems are exempt from this
  187. requirement provided they are not charging specifically for access to
  188. this one program.  Shareware distributors/User Groups may charge a nominal
  189. copying/library fee not to exceed $7.00.
  190. (small print off<g>)
  191.  
  192. ┌────────────────────┐
  193. │  Special Thanks    │
  194. └────────────────────┘
  195.  
  196.         Special thanks go out to:
  197.                 My wife Lori and son Bobby for tolerating my weird ways.
  198.                 Brett Martin for suggesting this utility and for writing
  199.                 the batch file that IMPORT will replace
  200.  
  201. ┌────────────────────┐
  202. │  Appendix          │
  203. └────────────────────┘
  204.  
  205.  
  206.    Appendix A
  207.    ──────────
  208.                         ┌──────────────────┐
  209.                         │ HISTORY:  IMPORT │
  210.                         └──────────────────┘
  211. Version         Date            Fixes, Changes, etc.
  212. ───────         ────────        ─────────────────────────────────────
  213. 1.0             04/15/93        First public release of the program.
  214.                                 Timed to coincide with the release of
  215.                                 READROOM v2.0.
  216.  
  217.    Appendix B
  218.    ──────────
  219.  
  220. Look for version 3.4 or later of LSTRELAY (due end of April 1993) to
  221. create a news screen everytime a publication is updated to enable your
  222. users to know when something new has come in!  File name is LR34.ZIP.
  223.  
  224. LSTRELAY is a utility that enables sysops to automate the generation
  225. of news files announcing time and date of last network mail transfer.
  226. LSTRELAY currently supports PCRelay, PostLink, GAPNet, Rnet and TNET
  227. network software.  The LSTRELAY utility allows the sysop to select
  228. either one screen design, or let the program select a different
  229. one each day.
  230.  
  231. LSTRELAY will also import a private message to the sysop in the main
  232. forum message base of the BBS.  This message will provide information
  233. regarding the status of the last mail run.  Sysop will be informed of
  234. the number of messages imported, number of messages exported, name of
  235. files requested/sent and other information collected from the network
  236. software's log file.
  237.  
  238.